home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / dvitovdu / vms / dvitovdu.hlp < prev    next >
Text File  |  1990-10-01  |  8KB  |  195 lines
  1. ! Help topics for DVItoVDU.  Keep lines < 77 characters long and
  2. ! watch for !, / and numbers in column 1.
  3. ! Details peculiar to our site are indicated by the string "! SYSDEP".
  4. ! Feel free to make modifications applicable to your site.
  5. !
  6. 1 DVItoVDU
  7.  
  8.  USAGE:  DVItoVDU filename[.DVI] [qualifiers]
  9.  
  10.  DVItoVDU is an interactive previewer that allows you to look at
  11.  TeX-generated DVI pages on a variety of commonly available VDUs.
  12.  The "DVItoVDU User Guide" has more details on how to use the program.
  13. ! SYSDEP
  14.  To print your own copy just type:
  15.  
  16.     $ PSPRINT disk$utils:[utilities.tex.dvitovdu]userguide
  17. !
  18. ! Now keep lines < 75 chars long.
  19. !
  20. 2 Commands_in_brief
  21.  
  22.  MISCELLANEOUS
  23.  -------------
  24.  ?          Display brief help on all the commands.
  25.  S          Show various qualifier values and current page statistics.
  26.  Q          Quit from DVItoVDU.
  27.  
  28.  SELECTING A PAGE
  29.  ----------------
  30.  i          Select the ith DVI page; i must be a positive integer from
  31.             1 to n where n is the total number of pages in the DVI file.
  32.  [i0...i9]  Select the DVI page whose TeX page counters match the given
  33.             integers, i0 to i9, separated by periods.  Any number of
  34.             integers may be absent; an absent integer matches any value
  35.             in the corresponding counter. Trailing periods may be omitted.
  36.             If more than one DVI page matches, the lowest will be chosen.
  37.  N          Select the Next DVI page, depending on current direction.
  38.  >          The N command will move forwards through the DVI file.
  39.  <          The N command will move backwards through the DVI file.
  40.  
  41.  CHANGING THE WAY A PAGE IS DISPLAYED
  42.  ------------------------------------
  43.  T          Terse display of characters; fast but inaccurate.
  44.  B          Box display showing rectangular outlines of characters.
  45.  F          Full display of all pixels in characters; accurate but slow.
  46.  
  47.  CHANGING THE UNITS OF DIMENSIONS
  48.  --------------------------------
  49.  IN         Get/show dimensions in terms of inches
  50.             (/RESOLUTION value = pixels per inch).
  51.  CM         Get/show dimensions in terms of centimetres (2.54cm = 1in).
  52.  MM         Get/show dimensions in terms of millimetres (10mm = 1cm).
  53.  PC         Get/show dimensions in terms of picas (1pc = 12pt).
  54.  PT         Get/show dimensions in terms of points (72.27pt = 1in).
  55.  PX         Get/show dimensions in terms of pixels.
  56.  
  57.  CHANGING THE SIZE OF THE WINDOW
  58.  -------------------------------
  59.  H wd       Set the Horizontal size of the window to the given width.
  60.             If wd absent, set width to initial, unscaled value.
  61.  V ht       Set the Vertical size of the window to the given height.
  62.             If ht absent, set height to initial, unscaled value.
  63.  ZI         Zoom In by halving the current window dimensions.
  64.  ZO         Zoom Out by doubling the current window dimensions.
  65.  
  66.  MOVING THE WINDOW OVER A PAGE
  67.  -----------------------------
  68.  W h,v      Move the Window's top left corner to given paper position.
  69.             h is the horizontal coordinate, v is the vertical coordinate.
  70.             If h,v is absent then the window is moved to (Minh,Minv),
  71.             the top left corner of the page rectangle.
  72.  U v        Move window Up v units. If v absent, move up an amount
  73.             equal to the window's current height.
  74.  D v        Move window Down v units. If v absent, move down an amount
  75.             equal to the window's current height.
  76.  L h        Move window Left h units. If h absent, move left an amount
  77.             equal to the window's current width.
  78.  R h        Move window Right h units. If h absent, move right an amount
  79.             equal to the window's current width.
  80.  
  81. 2 Qualifiers
  82.  
  83. /VDU=string
  84. (default=VT100)
  85.  
  86.  This qualifier is used to tell DVItoVDU what type of VDU you are using.
  87.  For example, typing `dvitovdu/vdu=vis550 foo' will tell DVItoVDU you're
  88.  using a VISUAL 550.
  89.  
  90.  The current version of DVItoVDU will accept the following /VDU values:
  91.  
  92.  AED483    (AED 512 with 512 by 483 screen)
  93.  AED512    (AED 512 with 512 by 512 screen)
  94.  ANSI      (any ANSI compatible VDU; synonym = VT100)
  95.  REGIS     (any ReGIS compatible VDU; synonyms = GIGI, VK100, VT125, VT240)
  96.  VIS240    (VISUAL 240; synonym = VIS241)
  97.  VIS500    (VISUAL 500)
  98.  VIS550    (VISUAL 550)
  99.  VT100132  (any VT100 compatible VDU in 132 column mode)
  100.  VT220     (VT220 using down-loaded chunky graphics; synonym = VT200)
  101.  VT640     (VT100 with Retro-Graphics)
  102.  
  103. /XSIZE=dimen
  104. /YSIZE=dimen
  105. (default=210mm=8.3in)
  106. (default=297mm=11.7in)
  107.  
  108.  These two qualifiers define the dimensions of the paper upon which your
  109.  document will be printed.  Both values are specified as +ve dimensions
  110.  similar to those used in TeX but units are restricted to IN, CM, MM, PC,
  111.  PT or PX (these two-letter sequences are the same as the commands used
  112.  to change the units of dimensions).
  113.  Every time you select a page, DVItoVDU will use these paper dimensions
  114.  to check that the page edges fall within the paper edges.
  115. ! SYSDEP
  116.  Note that their default values specify A4 paper.
  117.  
  118. /HOFFSET=dimen
  119. /VOFFSET=dimen
  120. (default=0mm)
  121. (default=0mm)
  122.  
  123.  These qualifiers can be used to shift the location of each page within
  124.  the paper.  You should only need to use them if you plan to print the
  125.  document with similar offsets.  Negative dimensions are allowed;
  126.  for example, "/hoffset=-.5in" shifts each page half an inch to the left.
  127.  
  128. /MAGNIFICATION=int
  129. (default=DVI magnification)
  130.  
  131.  This option allows you to replace the DVI magnification with some other
  132.  value; int is a positive integer 1000 times the desired magnification.
  133.  
  134. ! SYSDEP
  135.  If you plan to use PSPRINT's /MAGNIFICATION qualifier, you should supply
  136.  the same override to DVItoVDU; that way you'll see exactly what the
  137.  document will look like when printed.
  138.  Unless you know what you are doing you should avoid using /MAGNIFICATION,
  139.  especially if your TeX source uses \magnification AND true dimensions.
  140.  The complete story on magnification can be found in chapters 4 and 10
  141.  of "The TeXbook".
  142.  
  143. ! SYSDEP
  144. /PSPREFIX=string
  145. (default="PS-")
  146.  
  147.  DVItoVDU needs to read TFM files if your document uses resident PostScript
  148.  fonts (since bitmapped information does not exist).
  149.  All such fonts must have names beginning with this prefix.
  150.  
  151. ! SYSDEP
  152. /TFM_DIRECTORY=directory
  153. (default=disk$utils:[utilities.tex.fonts])
  154.  
  155.  Specifies the location of TFM files for resident PostScript fonts.
  156.  
  157. ! SYSDEP
  158. /FONT_DIRECTORY=directory
  159. (default=disk$utils:[utilities.tex.300pk])
  160.  
  161.  DVItoVDU gets all its bitmapped font information from files
  162.  located in the given directory.
  163.  
  164. ! SYSDEP
  165. /DUMMY_FONT=file
  166. (default=cmr10.300pk)
  167.  
  168.  If a requested font does not exist, DVItoVDU will first warn you, then
  169.  load the given font file (located in /FONT_DIRECTORY) and continue as best
  170.  it can so you can look for more errors.  Paragraphs using this dummy
  171.  information are likely to have ragged right margins.
  172. !
  173. ! SYSDEP: The above two qualifiers are used to tell DVItoVDU what type
  174. ! of bitmapped fonts you're using, and their location and naming convention.
  175. ! See DVITOVDU.CLD for more details.
  176.  
  177. ! SYSDEP
  178. /RESOLUTION=int
  179. (default=300)
  180.  
  181.  DVItoVDU treats the imaginary sheet of paper on which a DVI page will
  182.  appear as a two dimensional array of tiny dots known as pixels
  183.  (short for "picture elements").
  184.  int is a positive integer that defines the number of pixels per inch,
  185.  horizontally and vertically.  Its value should match the resolution
  186.  of the device that will be used to print your document.
  187.  Most laser printers currently have a resolution of 300 dots per inch.
  188.  
  189. ! SYSDEP
  190. /HELP_FILE=file
  191. (default=disk$utils:[utilities.tex.dvitovdu]help)
  192.  
  193.  The ? command reads the text file specified by this qualifier.
  194.  The default help file contains a brief summary of all the commands.
  195.